home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / g_man / cat3 / OpenGL / glutessendpolygon.z / glutessendpolygon
Encoding:
Text File  |  2001-04-17  |  5.5 KB  |  133 lines
  1.  
  2.  
  3.  
  4. gggglllluuuuTTTTeeeessssssssEEEEnnnnddddPPPPoooollllyyyyggggoooonnnn((((3333GGGG))))          OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee          gggglllluuuuTTTTeeeessssssssEEEEnnnnddddPPPPoooollllyyyyggggoooonnnn((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      gggglllluuuuTTTTeeeessssssssEEEEnnnnddddPPPPoooollllyyyyggggoooonnnn - delimit a polygon description
  10.  
  11.  
  12. CCCC SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  13.      void gggglllluuuuTTTTeeeessssssssEEEEnnnnddddPPPPoooollllyyyyggggoooonnnn( GLUtesselator* _t_e_s_s )
  14.  
  15.  
  16. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  17.      _t_e_s_s  Specifies the tessellation object (created with gggglllluuuuNNNNeeeewwwwTTTTeeeessssssss).
  18.  
  19. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  20.      gggglllluuuuTTTTeeeessssssssBBBBeeeeggggiiiinnnnPPPPoooollllyyyyggggoooonnnn and gggglllluuuuTTTTeeeessssssssEEEEnnnnddddPPPPoooollllyyyyggggoooonnnn delimit the definition of a
  21.      convex, concave or self-intersecting polygon. Within each
  22.      gggglllluuuuTTTTeeeessssssssBBBBeeeeggggiiiinnnnPPPPoooollllyyyyggggoooonnnn/gggglllluuuuTTTTeeeessssssssEEEEnnnnddddPPPPoooollllyyyyggggoooonnnn pair, there must be one or more
  23.      calls to gggglllluuuuTTTTeeeessssssssBBBBeeeeggggiiiinnnnCCCCoooonnnnttttoooouuuurrrr/gggglllluuuuTTTTeeeessssssssEEEEnnnnddddCCCCoooonnnnttttoooouuuurrrr. Within each contour,
  24.      there are zero or more calls to gggglllluuuuTTTTeeeessssssssVVVVeeeerrrrtttteeeexxxx. The vertices specify a
  25.      closed contour (the last vertex of each contour is automatically linked
  26.      to the first). See the gggglllluuuuTTTTeeeessssssssVVVVeeeerrrrtttteeeexxxx, gggglllluuuuTTTTeeeessssssssBBBBeeeeggggiiiinnnnCCCCoooonnnnttttoooouuuurrrr and
  27.      gggglllluuuuTTTTeeeessssssssEEEEnnnnddddCCCCoooonnnnttttoooouuuurrrr reference pages for more details.
  28.  
  29.      Once gggglllluuuuTTTTeeeessssssssEEEEnnnnddddPPPPoooollllyyyyggggoooonnnn is called, the polygon is tessellated, and the
  30.      resulting triangles are described through callbacks.  See gggglllluuuuTTTTeeeessssssssCCCCaaaallllllllbbbbaaaacccckkkk
  31.      for descriptions of the callback functions.
  32.  
  33. EEEEXXXXAAAAMMMMPPPPLLLLEEEE
  34.      A quadrilateral with a triangular hole in it can be described like this:
  35.  
  36.  
  37.           gluTessBeginPolygon(tobj, NULL);
  38.            gluTessBeginContour(tobj);
  39.              gluTessVertex(tobj, v1, v1);
  40.              gluTessVertex(tobj, v2, v2);
  41.              gluTessVertex(tobj, v3, v3);
  42.              gluTessVertex(tobj, v4, v4);
  43.            gluTessEndContour(tobj);
  44.            gluTessBeginContour(tobj);
  45.              gluTessVertex(tobj, v5, v5);
  46.              gluTessVertex(tobj, v6, v6);
  47.              gluTessVertex(tobj, v7, v7);
  48.            gluTessEndContour(tobj);
  49.           gluTessEndPolygon(tobj);
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. gggglllluuuuTTTTeeeessssssssEEEEnnnnddddPPPPoooollllyyyyggggoooonnnn((((3333GGGG))))          OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee          gggglllluuuuTTTTeeeessssssssEEEEnnnnddddPPPPoooollllyyyyggggoooonnnn((((3333GGGG))))
  71.  
  72.  
  73.  
  74.      In the above example the pointers, v1 through v7, should point to
  75.      different addresses, since the values stored at these addresses will not
  76.      be read by the tesselator until gggglllluuuuTTTTeeeessssssssEEEEnnnnddddPPPPoooollllyyyyggggoooonnnn is called.
  77.  
  78. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  79.      gggglllluuuuNNNNeeeewwwwTTTTeeeessssssss, gggglllluuuuTTTTeeeessssssssBBBBeeeeggggiiiinnnnCCCCoooonnnnttttoooouuuurrrr, gggglllluuuuTTTTeeeessssssssVVVVeeeerrrrtttteeeexxxx, gggglllluuuuTTTTeeeessssssssCCCCaaaallllllllbbbbaaaacccckkkk,
  80.      gggglllluuuuTTTTeeeessssssssPPPPrrrrooooppppeeeerrrrttttyyyy, gggglllluuuuTTTTeeeessssssssNNNNoooorrrrmmmmaaaallll, gggglllluuuuTTTTeeeessssssssBBBBeeeeggggiiiinnnnPPPPoooollllyyyyggggoooonnnn
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.